home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / get24.zip / GET24NEW.DOC < prev    next >
Text File  |  1991-11-03  |  15KB  |  298 lines
  1.   GET24NEW.DOC  -  New features in GET.EXE  -  Copyright 1991 Bob Stephan
  2.  
  3.   This file summarizes the new and improved features in the various 
  4.   releases of GET Version 2 through Release 2.4.  If you have been using 
  5.   an older version of GET, you should read this file to find out what 
  6.   has been changed, and what has been added.  Any items of interest 
  7.   mentioned here are fully described in GET.DOC.  This is merely a 
  8.   brief overview.
  9.  
  10.   Release 2.4:
  11.  
  12.   GET.EXE Release 2.4 contains only a few changes from Release 2.3. 
  13.   There are no bug fixes (none have been reported in 2.3) so if you 
  14.   don't need any of the new features, you can continue to use 2.3 with 
  15.   confidence.
  16.  
  17.   There were a very few reports of an apparent ROM BIOS incompatibility 
  18.     with one or two different systems which involved the method of 
  19.     displaying the prompt in 2.3.  The method was changed from Version 
  20.     2.2 to permit displaying the prompt in color or reverse video even 
  21.     with ANSI.SYS loaded.  It is now changed again to try to fix this 
  22.     BIOS incompatibility that so far has appeared only rarely.
  23.     Due to the most recent method now being used in Version 2.4, the 
  24.     maximum prompt length has to be limited to 79 characters if /A is 
  25.     used.  The "prompt" can also be used to send ANSI.SYS escape 
  26.     sequences to the screen.  See information on the /A switch below.
  27.  
  28.   GET R for 'Rithmetic - add or subtract two numbers. 
  29.     Syntax:  GET R[E] [num1] [/Wnum2]
  30.   
  31.   Input:  One or two numbers for arithmetic
  32.  
  33.   Process:GET R adds the two numbers
  34.           GET RE subtracts the second from the first
  35.  
  36.   Output: Arithmetic result in Environment and ErrorLevel
  37.           If only one number is given, the other number defaults to 0.  
  38.           Max number of digits for each number is 4.
  39.           Thus a character representation of a number can be converted
  40.             to a number in the ErrorLevel.
  41.           Example: A loop counter
  42.                    SET COUNT=0
  43.                    :LOOP
  44.                    GET R %COUNT% /W1 /VCOUNT=
  45.                    Echo The count is %COUNT%
  46.                    IF NOT ERRORLEVEL 10 GOTO LOOP
  47.           If the result is greater than 255, the ErrorLevel is modulo 256.
  48.              256=0, 257=1, ..., 511=255, 512=0, etc.
  49.           No negative numbers are recognized.  If a larger number is 
  50.           subtracted from smaller, the result is the difference + 65536.
  51.            Example: GET RE 10 /W20
  52.                     The ErrorLevel is 246
  53.                     The Environment is 65526
  54.  
  55.   SWITCHES:
  56.  
  57.   /A if the /A switch is not included, the prompt will be displayed 
  58.      in such a manner that ANSI sequences can be used for screen 
  59.      control.  This restores compatibility with Version 2.2 for 
  60.      prompting and using ANSI screen control sequences.  The "prompt"
  61.      will always be sent to the screen even if standard output is 
  62.      redirected with DOS redirection (>).  Without /A the prompt can 
  63.      be as long as will fit on the DOS command or BATch line which is 
  64.      limited to 128 characters total.  With /A, the prompt is limited 
  65.      to 79 characters.
  66.  
  67.   /T TRIM switch for GET S, GET Z, and GET HE.  
  68.          /TL or /T- will trim leading blanks.
  69.          /TR or /T+ will trim trailing blanks.
  70.              
  71.   /V- will suppress creation of the Environment variable completely.  
  72.      A side effect of /V- is that SET GET?=ON will have no effect.  
  73.      Since the search of the Environment is being completely bypassed, 
  74.      GET will not be able to check for the GET? variable.
  75.  
  76.   Two additions to the GET F command:
  77.  
  78.   /X Previously GET F always put the filesize in the Environment in 
  79.      hexadecimal.  Now it will be in decimal kilobytes, unless the /X 
  80.      for heX switch is included in which case it will be the full 
  81.      size in hex as before.
  82.  
  83.   A divisor can be provided for the GET F file size command similar to
  84.     the divisors permitted for GET K and GET Q.
  85.  
  86.     Syntax:  GET F filespec /Wnum
  87.  
  88.   NOTE: The use of GET F to test for the existence of a directory is 
  89.     valid only for subdirectories, and not for any root directory.
  90.     Since DOS does not recognize the root directory as a file, commands
  91.     such as GET F \, GET F c:\, GET F c:, etc. are not valid.  Also, 
  92.     if there is an error (no Environment variable) and the ErrorLevel 
  93.     is 15 it means that an invalid drive was specified.  These items 
  94.     were true in previous versions of GET, but were not described 
  95.     completely in the documentation.  Also, although it is a 
  96.     documented procedure in MS DOS 5.0, do not use the NUL device to 
  97.     check for a directory if any users might be using DR DOS 5.0.  DR 
  98.     DOS 5 thinks that the NUL (and other) devices exist even in 
  99.     non-existent directories.  It may be that a few other versions of
  100.     DOS do not support the NUL device method of checking, but GET will
  101.     work with them all.
  102.  
  103.   There is a minor improvement to the GET UE command.  Previously the 
  104.       value placed in the Environment for the key-lock status did not 
  105.       always match the value requested by the previous use of GET UE, 
  106.       although the saved result gave the same result if used to restore
  107.       the keyboard locks.  Now the value reported will match.
  108.  
  109.   There are some internal changes to reduce executable file size, but 
  110.       the runtime version could not be kept under 4K.  An additional
  111.       runtime version is available that does not have the T 
  112.       (moving Text) feature for those who do not use it.  This version
  113.       is still under 4K.  Look for GETNOT.EXE (GET NO T) on the
  114.       registered disk.
  115.  
  116.   One final clarification.  It has been pointed out that the documentation
  117.       for the VE (set border color) command does not clearly specify which
  118.       portions of the color table shown for /A are valid.  GET VE will 
  119.       take any of the 8 basic color codes 0-7.  The remaining information
  120.       that can be used for /A or GET B has no meaning for GET VE.
  121.  
  122.   If you have a modem, VISA and MASTERCARD registrations can be entered via 
  123.       NITELOG BBS, 408-655-1096.  After completing the brief sign-on registra- 
  124.       tion, enter S for Script, then 3 for Script 3.
  125.  
  126.   Release 2.3:
  127.  
  128.   GET.EXE, Release 2.3 contains many significant changes.  I have 
  129.   tried to maintain compatibility with GET 2.2, but there are a couple 
  130.   of changes that can cause some previous GET commands to behave 
  131.   differently.  In the cases where the new features duplicate 
  132.   previously available features, BATch programmers should make every 
  133.   effort to change over to the newer methods.  When Version 3 comes 
  134.   out at some future time, the older methods will be eliminated.
  135.   A compatibility warning feature has been included in GET 2.3. 
  136.   See GET.DOC for full details on these features.
  137.  
  138.   If you used GET for ANSI.SYS escape sequences, see the note under
  139.   the description of the /A switch.
  140.  
  141.   Size has increased only slightly.  The runtime version is still
  142.   under 4K as compressed.
  143.  
  144.   The biggest change in the syntax of GET commands is the addition of 
  145.   the use of switches to modify the commands.  This provides a richer, 
  146.   more flexible repertory of options for the BATch programmer.  The 
  147.   switches must come after all other arguments, and are indicated by 
  148.   the switch character which is the forward slash "/".  Switch letters 
  149.   can be entered in either lower or upper case.  The switches that
  150.   have been implemented in Release 2.3 are:
  151.  
  152.     /B flush keyboard Buffer.  May be useful to flush any type-ahead 
  153.        keystrokes when asking for user input.
  154.  
  155.     /C tells GET to handle Ctrl-C and Ctrl-Break instead of letting DOS do 
  156.        it.  
  157.  
  158.     /U specifies that the string that is written to the environment is 
  159.        to be forced into upper case (Caps).
  160.   
  161.     /L specifies that the string is to be forced into lower case.  
  162.  
  163.     /M tells GET to try to put the string in the master environment 
  164.        instead of the child environment.  
  165.  
  166.     /E specifies that keystrokes will be read from the Enhanced 
  167.        keyboard.  
  168.  
  169.     /X specifies that extended keys will be accepted.  
  170.  
  171.     /Vvar= specifies a name for the Environment variable other than 
  172.        GET.  
  173.     
  174.     /W is used to specify a number of seconds to wait for input.
  175.  
  176.     /A controls the screen attribute of prompts.  
  177.  
  178.     /~ This is a temporary switch that is used with GET S only.
  179.  
  180.   The next major enhancement is the handling of extended/enhanced 
  181.   keys.  For GET C and GET T you can now specify individual function 
  182.   and other extended keys by using a relatively simple but effective
  183.   surrogate scheme.  
  184.  
  185.     Other changes and enhancements:
  186.  
  187.     GET?.  To help in debugging, or simply to use GET from the command
  188.       line, you can tell GET to report to the screen what it is putting 
  189.       in the Environment and the ErrorLevel.  If you issue the DOS
  190.       command, SET GET?=ON, either from the command line, or in a BATch
  191.       file, then GET will tell you what it is doing.  
  192.   
  193.     GET S. When waiting for a string and the user presses Escape, GET 
  194.       can put the ESC surrogate, "~", in the Environment and 126 in the 
  195.       ErrorLevel (instead of 0 as before).  This is activated by using 
  196.       the /~ switch.
  197.  
  198.     GET BR is a new command to check and/or set the DOS BREAK Flag. 
  199.       GET BR also gives you another method of communicating from your 
  200.       CONFIG.SYS to your AUTOEXEC.BAT.  You can set BREAK ON or OFF in
  201.       CONFIG.SYS according to whatever you want it to mean, and use
  202.       GET BR to check and optionally reset it in your AUTOEXEC.BAT, then
  203.       take some action according to whether it was ON or OFF.
  204.  
  205.     GET 4 is a new get command to check for 4DOS or Windows.  In either 
  206.       case it will report 1 for "yes" and 0 for "no.
  207.         GET 4 finds out if 4DOS is the command processor.
  208.         GET 4E finds out if Windows is running. 
  209.  
  210.     GET I now reports the key that is waiting, and it takes the same 
  211.       aruguments as GET C so you can check for extended/enhanced keys.
  212.       Consequently, GET I does not use standard input any more.
  213.  
  214.     GET Z, as mentioned above, now does not look for the master 
  215.       environment unless the /M switch is included.  GET Z also has
  216.       enhanced string handling features.
  217.  
  218.     Release 2.2:
  219.  
  220.      Release 2.2 added a feature to put the string for GET Z "string"
  221.      in the true master environment, bypassing all copies of secondary
  222.      command processors.  It has been tested with DOS 3.3, DOS 4.01, 
  223.      DR DOS, and 4DOS, but it is a tricky business and there are no 
  224.      guarantees.  
  225.  
  226.      Release 2.2 also adds Escape to the list of recognized string 
  227.        characters for GET S, and it treats ASCII 255 as sort of an 
  228.        upper-case space character.
  229.      GET Y will now take a drive argument, and returns 0 for a root 
  230.        directory with GET=\.
  231.      GET 7E now returns a code for the type of CPU chip.  The PC Model
  232.        function has been reassigned to GET AE.
  233.      GET.DOC has been considerably expanded, and it includes clearer
  234.        LICENSING information.  A smaller runtime version is available
  235.        for a minimum registration fee.
  236.  
  237.   Release 2.1b:
  238.  
  239.      Release 2.1b included some additional documentation.
  240.      There were no new features in either 2.1a or 2.1b.
  241.      
  242.   Release 2.1a:
  243.  
  244.      Release 2.1a gives better results when using the K, L, or Q 
  245.      commands on a hard disk with large partitions.  Release 2.1 could 
  246.      report misleading information for such disks.
  247.  
  248.   ******************  New features in Version 2 **********************
  249.  
  250.   1. The capacity of a disk.  GET Q works just like GET K.
  251.      Note that the extended command now divides the ERRORLEVEL by 100 
  252.      instead of 10 as it did in the previous version.  And if you need 
  253.      a different divisor you can use the # notation.
  254.   2. Timeout.  C, N, and S now have a timeout capability.
  255.   3. Directory existence.  The F command for GET Filesize can now be used to
  256.      determine whether a named directory exists.  
  257.   4. SURROGATES: The surrogate for extended keys was changed to { because 
  258.      4DOS treats the "back quote" (grave accent) as a special character
  259.      in BATch files.  GET now works with DR DOS and 4DOS.  In previous
  260.      versions of GET, the surrogate for extended keys had to be the first
  261.      character in the argument if it was present.  Now it can be any place
  262.      in the argument.  
  263.        A new surrogate for extended keys on the enhanced keyboard (101 
  264.      keys) has been added.  
  265.        A surrogate for the space character ASCII 32 was added.
  266.        A surrogate of ASCII 253 will suppress Control-C and Ctrl_Break.
  267.   5. The I command checks to see whether a key is in the buffer.
  268.   6. The L command gets the Volume Label of the specified
  269.      disk.  The LE command will compare the "string" argument with the 
  270.      label and set the ERRORLEVEL to indicate whether there is a match.
  271.   7. The length of a string for the S command can be specified, and a
  272.      pattern can be given to limit the types of characters entered.
  273.   8. W will reboot the computer as if the 3-finger salute was pressed.  
  274.      WE will reboot as if the computer was turned off then on again.  
  275.      If any characters are present as an argument, instead of rebooting,
  276.      GET will attempt to determine whether the preceding boot was warm 
  277.      or cold.
  278.   9. GET AE will return the ROM BIOS model byte.
  279.  10. VE will get/set the border color on a VGA or EGA monitor.
  280.  11. PE has a change to inactivate Print-Screen.
  281.  12. The new H command provides Date and Time information.
  282.  13. Z (Zap) accesses the real master environment. 
  283.  14. The Moving Text option is back in Version 2.2.
  284.  15. The U command will stack keys in the keyboard bUffer.  UE will
  285.      adjust NumLock, CapsLock, and Scroll Lock.
  286.  
  287.   What new features do you need?  Your comments, questions, and 
  288.   suggestions are always welcome.  See GET.DOC for information on how
  289.   to contact me.
  290.  
  291.   You may have noticed that PC Magazine has come out with a BATch 
  292.   enhancer to handle strings.  Do you think that GET should also be 
  293.   able to do similar things with strings?  Or, would it be better to 
  294.   keep GET smaller, and use something like the PC Magazine utility if 
  295.   you need string handling features?
  296.                                             /Bob Stephan/
  297.                                             November 1, 1991
  298.